メインコンテンツまでスキップ

Google Workspace API 割り当てガイド

備考

**Google Drive API リクエストの制限に達すると、SHIELD DRM が自動的に再試行するため、文書は遅れてでも処理されます。管理者が行うべきことはほとんどありません。**ただし、大量アップロード直後は反映が遅れる場合があり、24時間以内に処理されなかった文書は再試行を停止します。

この文書は Google Workspace 環境に基づいています。Microsoft 365 環境のリクエスト制限は「MS サーボリングの案内」を参考にしてください。

Google Drive API の割り当てとは​

SHIELD DRMはGoogle Drive APIを使用して変更履歴を照会し、文書をダウンロードして処理した後、再度アップロードします。Googleはサービスの安定性のためにこのAPIに**リクエスト割り当て(Quota)**を置きます。

  • 割り当てはプロジェクト単位わユーザー単位に適用されます。短時間にリクエストが集中すると、Googleが一部のリクエストを拒否します。
  • 拒否応答は429 Too Many Requestsまたは403(rateLimitExceeded · userRateLimitExceeded)です。
  • 限度数値はGoogleが定めており、変更される可能性があります。最新の値はGoogleドキュメントUsage limitsを参照してください。

SHIELD DRMが使用するGoogle CloudプロジェクトはSHIELD DRMサービスが運営します。顧客が割り当てを別途申請したり調整したりする必要はありません。

SHIELD DRMの対応​

上限超過時の自動再試行​

リクエストが制限に達すると、SHIELD DRMはその作業を**指数バックオフ(Exponential Backoff)**方式で再試行します。

項目動作
再試行対象割り当て超過(429, 403リクエスト制限理由), Googleサーバー一時エラー(5xx)
再試行間隔15秒から始まり、試みるたびに2倍になり、最大30分です
再試行中断最初のリクエスト後24時間これを過ぎると、再試行は行いません。
  • 変更履歴の照会が制限に達した場合、最後に処理を完了した地点から再度照会します。検出された変更が欠落することはありません。
  • 権限不足のように再試行しても解決しないエラーは再試行しません。

変更通知チャネルの期限切れと再登録​

ドライブにインストールする変更通知チャネルは Google のポリシー上最大7日동안だけ有効です。SHIELD DRMは15分ごとにチャンネルをチェックして期限まで1日以内に残っているチャンネルを自動的に再登録します。管理者が定期的に再インストールする必要はありません。

大量変更処理​

多くの文書が一度にアップロードされると、SHIELD DRMは変更履歴を順番に照会・処理します。この時、ポリシーの反映が普段より遅れる可能性があります。すべての変更は順番に処理されます。

管理者が感じる症状と対応​

症状原因対応
アップロードした文書の暗号化解除が普段より遅い大規模アップロードによる割り当て超過または処理待機対処せずに待機します。自動再起動で処理されます。
1. 一日が過ぎても文書が処理されていない 2. 何か問題が発生しましたか? 3. すぐに確認します。24時間以内に再試行しましたが、処理できませんでした「文書変換ログ」で結果を確認します。文書を再アップロードするか保存して新しい変更を作成すると、再度処理対象になります。
特定のドライブの文書のみ全く処理されていない割り当ての問題ではなくチャンネル未設置また権限の問題である可能性が高い。「Google Drive イベント チャンネル」で該当ドライブのチャンネルインストール状況を確認します
新しく作成した共有ドライブが処理されていません新しい共有ドライブにはチャンネルが自動的にインストールされません。管理者ページで동기화後チャンネルをインストールします
管理者ページの동기화を連続して押すと拒否されますリストの同期は1分に1回のみ実行できます1分後に再実行します
警告

文書が処理されない最も一般的な原因は割り当てではなくチャンネル未設置です。反映の遅延を割り当てのせいにする前に、チャネルのインストール状況を確認してください。

参考文書​